[Script] Welcome Package -- Create Characters When Players Join

One of my pet peeves about making a new campaign has always been that my players can't make their characters right away when they join. Instead, there is the following chain of events that have to take place:

• Player joins campaign, can't do anything, and logs out.
• I log into campaign.
• I create a blank character for the player that joined earlier and then log out.
• Player logs in sometime later and is finally able to build their character.

Presented here is a quick and simple script that will immediately create a character for a player when they login, if they don't already have one, which they can then start editing right away. So the chain of events is reduced to:

• Player joins campaign and can immediately start building their character.

This script is available from the One-Click API script installer. Search for "Welcome Package".

Might add a !playerIsGM() in there to prevent you from having a character.  I might also suggest a sendChat() with a link to the Character whispered to that player (probably after a short timeout so it doesn't end up above the GiantGreenWelcomeBoxOfDoom.

The Aaron said:

Might add a !playerIsGM() in there to prevent you from having a character.  I might also suggest a sendChat() with a link to the Character whispered to that player (probably after a short timeout so it doesn't end up above the GiantGreenWelcomeBoxOfDoom.

Great ideas!

How do you get a URL for a character? I didn't know they were accessible outside of the VTT.

You can get a link players can click in the VTT that will pop it up as if you had shown it to them:

http://journal.roll20.net/character/CHARACTERID

That's a nice trick. Thanks!

Works for handouts the same way you might imagine. =D  You can see it put to good use in my Search script.

To the OP: that script works damn good. I'll be using it!  Thanks!

Stephen, this is genius. Thank you! I can't wait to add this to my games.

Another cool feature that should make it's way into roll20's game settings IMO.  Very nice.

Vince said:

Another cool feature that should make it's way into roll20's game settings IMO.  Very nice.

I mentioned this (among some other ideas for VTT improvements) to the devs a few months ago when I interviewed with them for the UI/UX developer job. I guess nothing really came of that though.

Since this script seems pretty useful to a lot of folks, I've made it into a full-fledged script including the enhancements that Aaron suggested. I've decided to call it the Welcome Package script. For now it is available here: https://github.com/Cazra/roll20-api-scripts/tree/3...

It requires the HtmlBuilder script. Hopefully soon it will also be available from the One-Click installer.

Awesome!!!! Will be using this with the next one-shot I do!

Want me to rename this thread: 

[Script] Welcome Package -- Create Characters When Players Join

The Aaron said:

Want me to rename this thread: 

[Script] Welcome Package -- Create Characters When Players Join

Yes, please!

Hi, nice script. I was using a different API for creating character sheets but it conflicted with Shaped Sheets. This one seems to work with Shaped Sheet.

However, is it possible to add an macro command so that a player with a pre-exsisting character sheet can type the command and be issued with a second character sheet. This happens quite often in my games, I run Adventurers League and people often have more than 1 character to use.

Kudos +1

Adding commands to allow players to add a new character and new handouts would be great!
(Though this should be a setting in roll20)

Alexander said:

Hi, nice script. I was using a different API for creating character sheets but it conflicted with Shaped Sheets. This one seems to work with Shaped Sheet.

However, is it possible to add an macro command so that a player with a pre-exsisting character sheet can type the command and be issued with a second character sheet. This happens quite often in my games, I run Adventurers League and people often have more than 1 character to use.

Kudos +1

Sure. I'll add that in once I get the chance.

The CreateACharacter macro is now implemented on the script up in Github.

I assume this isn't yet in the "auto-install API" dropdown?

Edit: Can it also auto-tag a sheet? Such as use the playername as a tag on the new sheet so it can be searched?

The API doesn't have access to tags. 

The Aaron said:

The API doesn't have access to tags. 

Booo. That makes it slightly less useful for my 'mass player game'

Actually, it is available now from the One-Click installer. Search for "Welcome Package".

Where is the code so I can copy and paste this?

I believe this is a One-click option now, but you can also find the code in the quote below

Stephen L. said:

I mentioned this (among some other ideas for VTT improvements) to the devs a few months ago when I interviewed with them for the UI/UX developer job. I guess nothing really came of that though.

Since this script seems pretty useful to a lot of folks, I've made it into a full-fledged script including the enhancements that Aaron suggested. I've decided to call it the Welcome Package script. For now it is available here: https://github.com/Cazra/roll20-api-scripts/tree/3...

It requires the HtmlBuilder script. Hopefully soon it will also be available from the One-Click installer.